Summary

• Add auto-scroll-into-view behavior for tooltip targets that exist in the DOM but are outside the visible viewport (or clipped by a scroll container). Before showing a tooltip, the SDK now checks whether the target is visible and, if not, performs a preflight check (canTooltipFitInViewport) to predict whether the tooltip can be successfully placed after scrolling. Only when the preflight passes does it smooth-scroll the target into view and wait for the scroll to settle before positioning.
• showTooltipComponent is now async to accommodate the scroll-and-wait cycle; all call sites and tests have been updated accordingly.
• Example page updated with two new demo buttons (offscreen page target and scroll container target) to exercise the feature.

Key Changes

tooltip-position-manager.ts

• canTooltipFitInViewport — simulates a centered viewport position for the target and checks whether findBestPosition would succeed, without actually scrolling.
• waitForScrollSettle — polls getBoundingClientRect().top until the target's position stabilizes or a timeout (1 s) elapses.
• ensureTargetInView — orchestrates visibility check → preflight → scrollIntoView({ behavior: 'smooth' }) → settle wait → post-scroll visibility confirmation.

message-component-manager.ts

• showTooltipComponent is now async; calls ensureTargetInView before positionTooltip and bails out early if the target cannot be brought into view.

message-manager.ts

• awaits the now-async showTooltipComponent.

Tests

• Full coverage for canTooltipFitInViewport and ensureTargetInView (already visible, offscreen with successful scroll, nested scroll container, preflight failure).
• All existing showTooltipComponent tests updated from sync to async.

Test Plan

• Run npm test — all existing and new tests pass
• Manual: open example page, click "Offscreen Page Target" — page smooth-scrolls to the below-the-fold button and tooltip appears
• Manual: click "Scroll Container Target" — item inside scroll container scrolls into view and tooltip appears
• Verify no scroll happens when tooltip would not fit (e.g., very large tooltip in a small viewport)
• Confirm no behavior change for targets already in the viewport